home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / usrchk14.zip / USERCHEK.DOC < prev    next >
Text File  |  1990-11-12  |  7KB  |  223 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                    SYSOP DOCUMENTATION USERCHEK
  11.  
  12.                              for the
  13.  
  14.                       IBM Personal Computer
  15.  
  16.                           Version 1.0
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                by
  23.  
  24.                             John Krytus
  25.                          246 Gardner Avenue
  26.                        Northwood, Ohio 43619
  27.                        Voice (419) 691-9700
  28.                        Data  (419) 691-1125
  29.  
  30.                             November 1990
  31.  
  32.  
  33. Disclaimer
  34. ----------
  35. This program is not public domain.  It is distributed under the
  36. concept of shareware.  Please contribute to this process as it
  37. is the only way it can work.
  38.  
  39. This product is provided "As Is" with no warranty, either expressed or
  40. implied.  All risk when running this product is with you.
  41.  
  42.  
  43. 1.0 Program Description
  44. -----------------------
  45. This file will take control of your bbs and callback users to
  46. verify they are who they say they are.  Userchek is strictly
  47. written for RBBS.  It uses whatever user interface files that
  48. are provided by rbbs.
  49.  
  50. 2.0 Required files
  51. ------------------
  52. You must have a batch file that you are running your RBBS from. 
  53.  
  54. The purpose of the files are as follows:
  55.  
  56. 1.      Userchek.exe    Main EXE program.
  57.  
  58. 2.      Sysop.doc       Documentation for Rbbs sysops.
  59.  
  60. 3.      Userchek.bat    Batch file to execute when rbbs exists
  61.                         to your door program.
  62.  
  63.  
  64.  
  65. 3.0 Setup
  66. ---------
  67. Normally, making a userchek subdirectory off of your rbbs
  68. subdirectory is the best way to set up this door.  Do this
  69. by typing MD USERCHEK in the rbbs subdirectory.
  70.  
  71. Setting up this door is easy as all you have to do is invoke
  72. the userchek.exe program.  You will be asked to enter various
  73. locations for files.  There are suggested defaults that you
  74. might want to accept. The following questions will be asked.
  75.  
  76. 1.      Enter the name and location of the dorinfo file.
  77.  
  78.         Normally, the location of this file is the same as the
  79.         location of rbbs-pc.exe.  Rbbs creates this file when
  80.         it goes to a door.  If you press return, the default
  81.         will be used.
  82.  
  83.         If the Dorinfo file cannot be found, userchek will
  84.         create one for you.
  85.  
  86.  
  87. 2.      The next question will ask you to enter the name of
  88.         door control file rbbs uses to adjust the user's
  89.         security.
  90.  
  91.         Normally, this file is named DOUT1.DEF.  Userchek
  92.         makes this file when returning to rbbs thereby,
  93.         adjusting the user's security level.
  94.  
  95.  
  96. 3.      The next question will ask you if you want your bbs
  97.         to be calling long distance.
  98.  
  99. 4.      The next question asks what the security level is that
  100.         will invoke the door to verify callers.  On my system
  101.         it is -3-.  Enter whatever security level you wish
  102.         here.
  103.  
  104. 5.      Here, enter the level of security to assign to the
  105.         caller should the caller pass the verify callback.
  106.  
  107. 6.      This question selects the prefix added to the dial
  108.         for your modem.  ATDP for pulse dialing and ATDT
  109.         for touch tone dialing.
  110.  
  111. 7.      Enter the location and filename where a log will be
  112.         kept of user verify tries.  Hitting enter will accept
  113.         the default.
  114.  
  115. 8.      This entry of a filename keeps track of the trash
  116.         numbers you want to check before your system dials.
  117.  
  118. 9.      This file keeps track of the numbers that were
  119.         successfully verified.  If a users phone number is in
  120.         this file, it will not be called again.
  121.  
  122.  
  123. 4.0 Running the Doorware program
  124. --------------------------------
  125. After  completing  the  setup as stated above insure that items
  126. #107 and #108 are completed.
  127.  
  128. Item #107 requests the name and location of the file to be invoked
  129. by rbbs when the verification takes place.
  130.  
  131. Item #108 requests the security level to watch for to invoke the
  132. verify program.
  133.  
  134. Userchek is invoked by the running of the batch file userchek.bat
  135. by rbbs.  Typical userchek batch file would be as follows:
  136.  
  137. NOTE:  You must not invoke a watchdog program to check for carrier
  138.        as this will reboot your machine during the callback process.
  139.        The watchkit timer line below is only there to keep things
  140.        going should there be an untrapped DOS error that results in
  141.        Abort, Retry, ...etc.
  142.  
  143. echo Please Standby....... > com1
  144. watchkit timer
  145. cd userchek
  146. userchek 1
  147. cd..
  148.  
  149. Line#1 of this file will send a message to the caller to please
  150. standby.  Change the comm port if applicable.
  151.  
  152. Line #2 invokes a program called watchkit that will reboot the
  153. bbs should an error occur that hangs the system.  Carrier detection
  154. is provided in the Userchek program.
  155.  
  156. Line #3 points to the userchek directory to run the userchek
  157. program.
  158.  
  159. Line#4 invokes the userchek program for the specific node.
  160.  
  161. Line #5 get us back to the rbbs subdirectory to give control back
  162. to rbbs.
  163.  
  164. You can run Userchek and not have it check for carrier by using
  165. the word LOCAL on the command line when starting it up.  During
  166. normal operation, the word local is not used.
  167.  
  168.  
  169. 5.0 Installation Summary:
  170. ------------------------
  171. I had to change my old user's security level to something less
  172. than 9 so that rbbs would run them thru the callback door. This
  173. might be the most time consuming part of this project.
  174.  
  175. TYPICAL OPERATION:
  176.  
  177. 1.   Caller logs on BBS.  If security level is below level set for
  178.      verification, rbbs asks users if they want to register.  If
  179.      they do, rbbs asks them to do newuser questionnaire.  After
  180.      questionairre, rbbs exits rbbs to the userchek program.
  181.  
  182. 2.   After userchek takes over, it gives users the necessary inform-
  183.      ation in order to complete the registration callback.
  184.  
  185. 3.   The callback routine generates a random 5 digit number.  The
  186.      caller is asked to write this number down and remember it.  Then
  187.      the users screen is erased and they are asked to key in the 5
  188.      digit number in again.  If successful up to this point, the
  189.      callback door disconnects the user and attemplts to call back.
  190.  
  191. 4.   If the connection is established, the callback routine asks the
  192.      user to enter the 5 digit number.  If the numbers match, the
  193.      callback routine gives control back to rbbs and the users sec
  194.      level is raised to the level specified in the  program init
  195.      part.
  196.  
  197.  
  198.  
  199. 6.0 Registration
  200. ----------------
  201. If you register your copy of userchek, I will send you via U.S.
  202. MAIL any and all improvements and fixes as they are implimented.
  203. Full registration for userchek is $25.00 per bbs.
  204.  
  205. If you send me $10.00, I will send you the latest version as of
  206. the day I receive your request.
  207.  
  208. 7.0 Help
  209. --------
  210. I have a 24 hour bbs online.  If you have comments or questions
  211. give us a call.
  212.  
  213. 8.0 Multi-user Operation
  214. ------------------------
  215. In order to run this door multiuser, one must set up a usrchk?.def
  216. for each node to be accessed by userchek.
  217.  
  218. For Instance, node 1's def file would be usrchk1.def and node 2's
  219. def file would be usrchk2.def.
  220.  
  221. Specify the dorinfo1 or dorinfo2 file as appropriate.
  222.  
  223.